Skip to content

docs: explain SDK browser conversation event streams - #795

Open
neubig wants to merge 6 commits into
mainfrom
docs/conversation-event-stream
Open

neubig wants to merge 6 commits into
mainfrom
docs/conversation-event-stream

Conversation

@neubig

@neubig neubig commented Sep 12, 2026 •

Copy link
Copy Markdown
Member
  • I have read and reviewed the documentation changes to the best of my ability.
  • If the change is significant, I have run the documentation site locally and confirmed it renders as expected.

Summary of changes

Document the SDK-owned browser conversation event stream, including authentication, replay, reconnects, lifecycle callbacks, cleanup, and REST fallback. Add navigation and overview links. Mark the API unreleased so this guide ships with its SDK release.

Fixes #794. SDK implementation: OpenHands/software-agent-sdk#5013; Canvas consumer: OpenHands/OpenHands#17389.

Validation: JSON navigation parses and git diff whitespace checks pass. The client example's authentication and reconnect behavior was exercised against the isolated Agent Server. The guide now renders in the local Mintlify preview with HTTP 200 and no browser errors; details and the exact constructor probe are linked below.

Recorded evidence

The guide rendered with HTTP 200 and no browser errors. Its exact stream constructor authenticated, replayed a real completed model conversation, and reconnected. The message-send example was not invoked. Report and artifacts. Links are pinned to the artifact commit so review cleanup cannot invalidate them.

@mintlify

mintlify Bot commented Sep 12, 2026 •

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
all-hands-ai 🟢 Ready View Preview Sep 28, 2026, 3:25 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

@neubig
neubig requested review from all-hands-bot and removed request for all-hands-bot September 13, 2026 15:34
@neubig
neubig requested review from all-hands-bot and removed request for all-hands-bot September 13, 2026 18:04
@neubig
neubig marked this pull request as ready for review September 28, 2026 15:02
@neubig
neubig requested a review from enyst as a code owner September 28, 2026 15:02

This branch was successfully deployed

1 active deployment
staging — 343e7269 Deployed Sep 28, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document SDK-owned browser conversation event streams

2 participants